home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 June / EnigmA AMIGA RUN 08 (1996)(G.R. Edizioni)(IT)[!][issue 1996-06][EARSAN CD VII].iso / earcd / gui / gtldv374.lha / GadUtil / Docs / GUtil_CSAA.txt < prev    next >
Text File  |  1996-05-14  |  9KB  |  213 lines
  1.  
  2. TITLE
  3.     GadUtil.library
  4.  
  5. VERSION
  6.     37.4 (14.05.96)
  7.  
  8. AUTHORS
  9.  
  10.     Per-Olof Yliniemi                           Staffan Hämälä
  11.     Box 78                                      Pellovägen 268
  12.     S-980 61 Tärendö                            S-957 93 Pello
  13.     SWEDEN                                      SWEDEN
  14.  
  15.     email:                                      email:
  16.       peoyli@pluggnet.se                          staham@pluggnet.se
  17.  
  18.     phone:
  19.       +46-(0)978-20522
  20.  
  21. DESCRIPTION
  22.  
  23.     GadUtil is another gui library which main goal was to make it easy to
  24.     create font sensitive user interfaces. The library has grown away from
  25.     this main goal, and become another useful-routine-library.
  26.  
  27. FEATURES
  28.  
  29.     * FAST (NO OR VERY SMALL DIFFERENCE AGAINST GADTOOLS) AND SMALL (LESS THAN 10k).
  30.       WRITTEN IN ASSEMBLY LANGUAGE. NO F*CKING 'C' or any other slow language!
  31.  
  32.     * Font adaptive. Use any of the system fonts and most other fonts for
  33.       gadgets, texts and menus. All gadgets are placed relative to each
  34.       other, but can be placed at absolute positions (needed for the first
  35.       gadget).
  36.  
  37.     * No need to use GIMMEZEROZERO windows, as this is automatically handled
  38.       by the library. If you specify a gadget position of 10,10 the gadget
  39.       will be placed at 10,10 within the window's border.
  40.  
  41.     * Localized. It is really easy to localize all your (new) programs by
  42.       using this library. Functions and macros for creating localized menus
  43.       are supplied.
  44.  
  45.     * Both assembly and 'C' language support. This is one of the things that is
  46.       missing in most of the other gui libraries. Some extra macros are defined
  47.       for assembly language users, and will make the gadget and menu creating
  48.       process even more easy.
  49.  
  50.     * All GadTools gadgets are supported. Some extra functions are provided
  51.       for ListViews. BUTTON_KIND (and IMAGE_KIND) gadgets have some extra tags,
  52.       including a toggle-select option.
  53.  
  54.       6 extended gadget types are handled by the library:
  55.     
  56.         · FILE_KIND     - gadget for selecting a file.
  57.  
  58.         · DRAWER_KIND   - gadget for selecting a drawer. Most programs also
  59.                           use this gadget for file selection.
  60.  
  61.         · IMAGE_KIND    - uses an intuition image for the gadget. Can use
  62.                           different images for selected and non-selected state.
  63.                           Two different ways of displaying the selected state of
  64.                           gadgets with only one image.
  65.  
  66.         · BEVELBOX_KIND - gadtools bevelboxes, with some extensions. All
  67.                           gadtools bevelboxes are supported (even with v37).
  68.                           Extensions allows text to be placed above, in or below
  69.                           the upper line of the box. All kinds can be inverted.
  70.  
  71.                           New for v36.52: Bevelbox text placement extended.
  72.                           3 new placements available together with the old
  73.                           ones: centered, left adjusted & right adjusted.
  74.  
  75.                           BFT_BUTTON   - GT v37 BUTTON_KIND border
  76.                           BFT_RIDGE    - GT v37 STRING_KIND border
  77.                           BFT_DROPBOX  - GT v39 BBFT_ICONDROPBOX border
  78.                           BFT_HORIZBAR - A horizontal shadowed line
  79.                           BFT_VERTBAR  - A vertical shadowed line
  80.  
  81.                           This makes it a total of 100 bevel box types. The bevel
  82.                           boxes are treated as gadgets by the library, and you
  83.                           can obtain the structure for the bevelbox in the same
  84.                           way as you get the gadget pointer.
  85.  
  86.                           New for v36.53: Added optional shadow on bevel box text.
  87.                           The shadow has a selectable color/pen and the "sun" can
  88.                           be placed in four different positions.
  89.  
  90.         · PROGRESS_KIND - progress indicator gadget. Background and fill color
  91.                           can be selected. Supports values up to 4.294.967.295,
  92.                           but maximum value should not exceed 4.294.967.295/width.
  93.                           v36.55.
  94.  
  95.         · LABEL_KIND    - a text label that can be placed relative to other texts,
  96.                           gadgets, bevelboxes and progress indicators. v37.4.
  97.  
  98.     * Can create the minimum required IDCMP mask so that all gadgets works.
  99.  
  100.     * A new OpenFont (graphics.library and diskfont.library replacement) is supplied.
  101.       This function will open any font (from RAM, ROM or load it from disk).
  102.  
  103.     * A new CloseFont is supplied , so that you don't have to open graphics.library
  104.       to close a font opened by diskfont/OpenFont or gadutil/OpenFont.
  105.  
  106.     * Functions for listviews include adding nodes (memory for the string is
  107.       allocated by the function), counting nodes, getting node pointers, clearing
  108.       a listview, attach and detach lists, moving nodes up and down. A function
  109.       that allows you to sort one or two lists is included from v36.59.
  110.  
  111.     * No need to open gadtools.library anymore, since all gadtools functions are
  112.       provided through this library. Some (the most useable) functions from locale
  113.       library are also provided by gadutil.
  114.  
  115.     * Many libraries are opened through gadutil.library, and these library bases
  116.       are available for your own use (you don't have to open or close some libs).
  117.  
  118.     * All gadgets are created using tag lists. Every next gadget will use the
  119.       previous gadgets values as defaults. Only one call to the gadget making
  120.       routine is needed for every gadget list.
  121.  
  122.     * All gadgets can have their own hotkey. No extra work is needed by the
  123.       programmer (only one extra tag).
  124.  
  125.     * Distributed with lots of examples, mostly in assembly language, but also
  126.       in 'C'.
  127.  
  128.     * Other functions include:
  129.  
  130.         · Status change for toggle select buttons.
  131.  
  132.         · String change for STRING and TEXT_KIND gadgets.
  133.  
  134.         · Disable functions for all gadget kinds (new for 36.56).
  135.  
  136.         · Routines to set up a busy-pointer (available for both v37 and v39). These
  137.           routines also blocks the input to the main window of the program.
  138.  
  139.         · Routine to check if the mouse pointer is within a gadgets box. Useful
  140.           for mouse-position sensitive appwindows.
  141.  
  142.         · Bevelbox and window refreshing functions.
  143.  
  144.         · Functions to clear and size/move windows
  145.  
  146.     * FAST (NO OR VERY SMALL DIFFERENCE AGAINST GADTOOLS) AND SMALL (LESS THAN 10k).
  147.       WRITTEN IN ASSEMBLY LANGUAGE. NO F*CKING 'C' or any other slow language!
  148.  
  149. SPECIAL REQUIREMENTS
  150.    
  151.     AmigaOS 2.0 or higher.
  152.  
  153. AVAILABILITY
  154.  
  155.     Any Aminet site, such as ftp.wustl.edu/pub/aminet
  156.                           or sunsite.auc.dk/mirrors/aminet
  157.  
  158.     dev/gui/gutil_dev_374.lha       Complete archive for developers & users
  159.     util/libs/gutil_usr_374.lha     User part only
  160.  
  161.     The most recent version can always be found on my homepage at
  162.  
  163.     http://hotspot.pluggnet.se/~peoyli
  164.  
  165.     html_eng/myprogs.html           English descriptions of all my programs
  166.     html_swe/myprogs.html           Swedish descriptions of all my programs
  167.  
  168. PRICE
  169.     Always free for all users of the library.
  170.  
  171.     Programmers:
  172.  
  173.     1) Programmers of totally free software can use and distribute this
  174.        library for free.
  175.  
  176.     2) Programmers of Shareware, Licensware, commercial products and other
  177.        programs that the programmer get any kind of profit from shall send
  178.        a fully working (and registered) copy of the program and its docs to
  179.        us. All larger updates of the program should also be sent to us.
  180.           
  181.     3) Programmers of non-free software not covered by 1) and 2) (my Diskware
  182.        concept belongs to this group) shall be treated as in 2) (a fully
  183.        working and registered copy...).
  184.  
  185.     4) All programs (except commercial products in some cases) must state
  186.        that gadutil.library is used. This may be done in either the About
  187.        requester or in the documentation, but best of all in both places.
  188.  
  189.        Demonstration programs for gadutil.library (that includes the full
  190.        source) may be distributed without this note.
  191.  
  192.        Example for inclusion in About requester:
  193.  
  194.                 "This program uses gadutil.library, which
  195.                  is Copyright © 1994-1996 by P-O Yliniemi
  196.                  and Staffan Hämälä."
  197.  
  198.     5) All localized programs that uses this library should include the
  199.        .ct file(s) to allow anyone to translate that program into their
  200.        own language.
  201.  
  202.  
  203. DISTRIBUTION
  204.  
  205.     Freely distributable via CD, disk, FTP or any other form.
  206.  
  207.     Distribution may be done in two ways:
  208.     · Only the .library file(s), together with your program (programmers)
  209.     · The complete distribution archive(s)
  210.  
  211.     GadUtil is © 1994-1996 by P-O Yliniemi and Staffan Hämälä.
  212.  
  213.